home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / xlist232.zip / XLIST.DOC < prev    next >
Text File  |  1989-12-18  |  38KB  |  1,205 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                         XLIST (tm)
  17.  
  18.                         DISK MANAGER
  19.  
  20.                         USERS GUIDE
  21.  
  22.                         for the
  23.  
  24.                         IBM PC/AT
  25.  
  26.  
  27.  
  28.  
  29.                         by
  30.  
  31.                         GARY W. WOOD
  32.  
  33.  
  34.         *** READ CAREFULLY BEFORE USING XLIST ***
  35.             PROGRAM LICENSE AGREEMENT
  36.  
  37. XLIST (tm) is NOT "Public Domain" and it is NOT "Freeware".  XLIST is a
  38. copyrighted software product developed and owned by Gary W. Wood.  XLIST (tm) is
  39. distributed under the shareware concept.  You are free to copy and use the
  40. software for personal use.  If you are a corporation or institution a license
  41. fee in required.  But, if you are using the software for personal use, your
  42. encouraged to make a gift ($25 suggested) and become a XLIST supporter.  XLIST
  43. supports will receive the next major release free of charge and be keep informed
  44. of major developments for one (1) year.  A license is required for use of XLIST
  45. by corporations and institutions, and for its commercial distribution.    You may
  46. obtain a license for the use of XLIST by writing to me.  The license is for
  47. perpetual, non-exclusive use of any version.  Purchase orders and invoicing are
  48. acceptable.  If you have special requirements, such as licensing for an unlimited
  49. number of copies, local area networks, site licenses, or customization, please
  50. feel free to submit them in writing.  You may request a license for:
  51.  
  52. o  an unlimited number of end user copies at a single site;
  53. o  customization of messages and documentation,  an additional
  54.    fee may be required depending on the extent of changes;
  55. o  permission to distribute within your organization;
  56. o  permission to include with your company's commercial products;
  57. o  or other needs.
  58.  
  59. The fee for a license depends on the estimated number of copies of the program
  60. that you will use.  If you wish to distribute XLIST with your own programs or
  61. hardware, write for a "Marketing License".  To use the discount schedule below,
  62. estimate the total number of copies that you may eventually use.
  63.  
  64.       Number of users(copies)    Price per copy
  65.           1 to 9            $ 25.00
  66.           10 to 25              18.00
  67.           26 up              (call)
  68.  
  69. Regardless of the quantity, only one set of materials will be sent to you.  You
  70. may then make as many copies of it that are licensed.  Maintenance is free.
  71. Upgrades will be made available upon request.  Technical support is available
  72. via mail, or through the Compuserve or GENIE bulletin board systems (76156,317
  73. & G.WOOD4 respectively), at no charge.
  74.  
  75.           Copyright (C) 1985-1990 Gary W. Wood
  76.  
  77.  
  78.  
  79.  
  80. If you find XLIST easy and convenient to use, a contribution of $25 or more will
  81. register you to receive a current version of XLIST.  Please state the current
  82. version of XLIST that you have.  Send contributions to:
  83.  
  84.       Gary Wood
  85.       5401 Lakeview Road
  86.       North Little Rock, Arkansas  72116
  87.  
  88. All rights reserved.  Printed in the United States of America.    No part of this
  89. publication may be reproduced, stored in a retrieval system, or transmitted in
  90. any form or by any means, electronic, mechanical, photocopying, recording, or
  91. otherwise without the prior written permission from Gary W. Wood, 5401 Lakeview
  92. Road, North Little Rock, Arkansas, 72116.
  93.  
  94.  
  95.  
  96.  
  97.                DISCLAIMER
  98.  
  99. The author has taken due care in the preparation of this document and the
  100. associated program.  Insofar as specific mention of program features, the author
  101. believes the information to be true.  No warranty is made regarding the
  102. suitability of the program to be compatible with your computer.  Incidental and
  103. consequential damages caused by malfunction, defect, or otherwise are not the
  104. responsibility of Gary W. Wood, and to the extent permitted by law, and hereby
  105. excluded both for the property and, to the extent not unconscionable, for
  106. personal injury damage. (Some states or jurisdictions do not allow the exclusion
  107. or limitation of incidental or consequential damages, so the above limitation
  108. or exclusion may not apply to you.)  Gary W. Wood also reserves the right to make
  109. amendments to the contents of this document from time to time, to reflect changes
  110. made to the specification of the XLIST system or for any other reason.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. XLIST is a Trademark of Gary W. Wood.  IBM, IBM-PC, PC-XT, PC-AT, DOS, and PC-DOS
  125. are Trademarks of International Business Machines Corp.
  126.  
  127.  
  128. CHAPTERS
  129.  
  130.  
  131.  
  132. 1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .  5
  133.  
  134. 2.  Getting Started   . . . . . . . . . . . . . . . . . . . . . . .  6
  135.  
  136. 3.  Invoking the XLIST Command    . . . . . . . . . . . . . . . . . .  8
  137.  
  138. 4.  Using the Keyboard    . . . . . . . . . . . . . . . . . . . . . .  9
  139.  
  140. 5.  Using the XLIST.CNF File  . . . . . . . . . . . . . . . . . . . 10
  141.  
  142. 6.  Using the XLIST.PRO Profile . . . . . . . . . . . . . . . . . . 11
  143.  
  144. 7.  Sample XLIST.PRO File . . . . . . . . . . . . . . . . . . . . . 20
  145.  
  146. 8.  Command Line Commands . . . . . . . . . . . . . . . . . . . . . 23
  147.  
  148.  
  149.  
  150.  
  151. INTRODUCTION
  152.  
  153.  
  154.  
  155. WELCOME TO THE WORLD OF DISK MANAGEMENT USING
  156. XLIST - DISK UTILITY
  157.  
  158. If you are new to PC-DOS, you have realized that commands provided by PC-DOS
  159. are designed to be short and sweet.  This program is designed as a tool to
  160. effectively provide the user a friendly way to view files contained in sub-
  161. directories and be able to execute programs and PC-DOS commands.
  162.  
  163.  
  164. GETTING STARTED
  165.  
  166.  
  167.  
  168. WHAT KIND OF HARDWARE DO I NEED
  169.  
  170.  
  171. To use XLIST you need the following:
  172.  
  173. An IBM PC with hard disk, PC XT, PC AT, or a very closely compatible
  174. microcomputer.
  175.  
  176. A color/graphics adapter, monochrome adapter, or VGA adapter
  177.  
  178. 256K of RAM memory for best results.  The program requires at least 120K of
  179. memory.
  180.  
  181. One diskette drive
  182.  
  183. DOS 2.1 or greater
  184.  
  185.  
  186.  
  187. WHAT DO I DO NOW
  188.  
  189.  
  190. Installing XLIST to operate on your system is a simple process.You should
  191. start by copying the distribution diskette and putting the original away in a
  192. safe place.
  193.  
  194. Now, copy the files on the diskette to a directory on your hard disk searched
  195. by the DOS path.  The PC-DOS "PATH" command specifies a directory search order
  196. for commands and/or batch files that are not in the current directory.
  197.  
  198. For best performance of XLIST, set the following environment parameters.
  199.  
  200.      SET OVERLAY=D:\     <--- Point to work area or RAM disk.
  201.      SET XLIST=LIST     <--- The name of a browser or editor.
  202.  
  203. You are now ready!
  204.  
  205.  
  206. INVOKING THE XLIST COMMAND
  207.  
  208.  
  209. WHAT ARE THE INVOKING PARAMETERS
  210.  
  211.  
  212. First, no parameters are mandatory, but under some conditions you may want to
  213. specify them to limit or expand the directory entries displayed.
  214.  
  215. To invoke the program enter:
  216.  
  217.        XLIST [[d:][path][filename[.ext]] /Mnn /A /L
  218.  
  219. The optional parameters have the following definitions:
  220.  
  221.   [[d:][path][filename[.ext]] to specify the file and/or files
  222.        that will be initially be displayed by the XLIST screen.
  223.  
  224.   [/Mnn] is used to specify a directory attribute that will override the
  225.        attribute that could be specified in the profile with the *DIRATTR
  226.        parameter.
  227.  
  228.   [/A] is used to tell XLIST to load every file on the default
  229.        drive into XLIST.
  230.  
  231.   [/L] is used to tell XLIST to display license information.
  232.  
  233.  
  234. Example:
  235.  
  236. Execute XLIST loading the directory from the default drive directory and the root
  237. directory of the C: drive.
  238.  
  239. XLIST *.* c:\*.*
  240.  
  241.  
  242.  
  243. USING THE KEYBOARD
  244.  
  245.  
  246. WHAT KEYS ON THE KEYBOARD DOES XLIST USE
  247.  
  248.  
  249. XLIST uses the keyboard for communications.  The keyboard is used to enter
  250. commands, scroll the display, and to invoke user-defined function keys.  These
  251. are the single keystroke commands used by XLIST.  You may change command keys
  252. by using the "Alt-k" key.  Defaults are defined as follows:
  253.  
  254.      Key Stroke            Definition
  255.  
  256.        Home       Position the cursor to the first character.
  257.  
  258.        End     Position the cursor to the last character.
  259.  
  260.        Ctrl End     Erase data in the command line from the
  261.             cursor to the end-of-line.
  262.  
  263.        Alt a     Change file attributes.
  264.  
  265.        Alt c     Change screen colors.
  266.  
  267.        Alt e     Toggle to EGA 43-line screen.
  268.  
  269.        Alt f     Toggle to set XLIST to stop processing
  270.             when an error